HandStack 라우팅의 마법

Controller 라우팅: C# 코드가 URL로 (1/2)

• HandStack은 C# Controller의 이름과 메서드(Action) 이름을 조합하여 API 주소를 자동으로 만듭니다.

• 예시 (transact 모듈 기준):

  • Controller 클래스 이름: TransactionController (Area: transact)
  • Action 메서드 이름: Execute
  • 변환된 URL: /transact/api/transaction/execute

• 코드에서는 다음과 같은 속성(Attribute)으로 정의됩니다.

Controller 라우팅: C# 코드가 URL로 (2/2)

[Area("[모듈 ID]")]
[Route("[area]/api/[controller]")]
public class UserManagementController : Controller
{
    [HttpGet("[action]")]
    public async Task<object> GetUserProfile()
    {
        // ... 로직 ...
    }
}

Razor Pages 라우팅: 파일 경로가 URL로 (1/2)

• 웹 페이지를 만드는 Razor Pages의 경우, 파일과 폴더의 경로가 그대로 URL 주소가 됩니다.

• 예시:

  • 파일 경로: Pages/UserProfile/EditProfile.cshtml
  • 변환된 URL: /user-profile/edit-profile

• 페이지 상단에는 어떤 모듈에 속하는지 명시합니다.

Razor Pages 라우팅: 파일 경로가 URL로 (2/2)

@page
@model [모듈 ID].Areas.[모듈 ID].Pages.UserProfile.EditProfileModel
@{
    // ... 페이지 내용 ...
}

라우팅 규칙을 직접 바꿀 수도 있나요? (1/2)

• 네, 가능합니다.

• HandStack은 자동 kebab-case 라우팅을 기본으로 제공하지만, 필요에 따라 URL을 직접 지정할 수도 있습니다.

• Controller Action에 [Route] 속성을 사용하면 원하는 주소로 변경할 수 있습니다.

라우팅 규칙을 직접 바꿀 수도 있나요? (2/2)

[HttpGet]
[Route("get-my-special-user")] // URL을 직접 지정
public async Task<object> GetUserProfile()
{
    // ... 로직 ...
}

• Action 경로는 Controller의 Route 접두사 뒤에 붙습니다. 앞의 [area]/api/[controller] 예제라면 /[모듈 ID]/api/user-management/get-my-special-user가 됩니다.